---
title: SAIF.Business.Utilities overview
summary: High-level purpose, scope, and responsibilities for this library.
status: draft
owner: SAIF Documentation Generation
last_reviewed: 2026-08-21
library: SAIF.Business.Utilities
reference_type: embedded
---

# SAIF.Business.Utilities overview

> **Documentation context:** Embedded component — documented from source within this repository.

SAIF.Business.Utilities is a small, stateless text-formatting utility library within the SAIF BOF Claims/Legal solution. It converts raw stored text (typically all-caps names, addresses, or statuses from Oracle-backed business data) into human-readable mixed case, and converts numeric amounts into English word form.

## Purpose
- Convert all-caps or inconsistently cased stored strings into human-readable "title case" via `TitleCase.ToTitleCase` and the `.ToTitleCase()` string extension, using curated word lists to handle abbreviations, connector words, name prefixes/suffixes, and ordinal suffixes.
- Spell out numeric (`Long`) values as English words via `mdlTextConversion.NumberToText`, for amount-in-words style rendering, up to a 999,999,999,999,999 ceiling.
- Consumed by higher business-layer libraries — `SAIF.Business.Policy.Agency` and `SAIF.Business.View.Policy` — to format display-name and status values sourced from Oracle-backed business data.

## Responsibilities
- Provide a delimiter-preserving, word-list-driven title-casing algorithm (`TitleCase`) that classifies each token as upper-case, lower-case, mixed-case-exception, ordinal, or name-prefixed, and reassembles the string with original punctuation/whitespace intact.
- Expose the title-casing algorithm and related string helpers (`.ToProperCase()`, `.ToPadCapitalLetters()`, `.ToLower()`/`.ToUpper()` for string arrays, `.ContainsOnlyNumericCharacters()`) as `.ToXxx()` extension methods via `TitleCaseExtensions`.
- Provide numeric-to-English-words conversion (`mdlTextConversion.NumberToText`) and a simple sentence-case transform (`.ToSentenceCase()`).
- Hold no mutable instance state and perform no data access, business-object lifecycle participation, or UI involvement — every public entry point is a `Shared`/`Module`-level pure function.

## Key components
- `TitleCase`: owns the title-casing algorithm — tokenization, per-token case classification against curated word lists, delimiter-preserving reassembly, and possessive-suffix handling.
- `TitleCaseExtensions`: thin extension-method adapter exposing `TitleCase.ToTitleCase` and related string helpers as `.ToXxx()` methods callable directly on `String`/`String()` instances.
- `mdlTextConversion`: owns numeric-to-English-words conversion (`NumberToText`) and the `ToSentenceCase` extension.

## Related documentation
- [Index](index.md)
- [Architecture](architecture.md)
- [Dependencies](dependencies.md)
- [Operations and processes](operations-processes.md)
- [Business rules](business-rules.md)
- [Configuration settings](configuration.md)
- [API reference](api/index.md)

## Sources
- SAIF.Business.Utilities\SAIF.Business.Utilities.vbproj
- SAIF.Business.Utilities\TitleCase.vb
- SAIF.Business.Utilities\mdlTextConversion.vb
- .saifdocgen/state/runs/20260821-113120-claims-bof-web-legal/analysis/TSK007-analysis.md